home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / amiga / convrtrs / pbmplus / update4.lha / readme.ilbm < prev    next >
Encoding:
Text File  |  1993-07-09  |  3.8 KB  |  123 lines
  1. ppmtoilbm [-maxplanes|-mp n] [-fixplanes|-fp n]
  2.           [-ham6|-ham8] [-dcbits|-dcplanes r g b]
  3.           [-normal|-hamif|-hamforce|-24if|-24force|-dcif|-dcforce|-cmaponly]
  4.           [-ecs|-aga] [-map ppmfile] [ppmfile]
  5.  
  6.  
  7. Supported ILBM types:
  8.     * normal ILBMs with 1-16 planes
  9.     * HAM with 3-16 planes
  10.     * 24bit
  11.     * colormap (BMHD + CMAP chunk only, nPlanes = 0)
  12.     * unofficial direct color with 1-16 planes for each color component
  13.  
  14.  
  15. Options:
  16.     Options marked with (*) can be prefixed with "no", ie "-nohamif" etc.
  17.     All options can be abbreviated to their shortest unique prefix.
  18.  
  19.     -maxplanes|-mp n (default 5, minimum 1, maximum 16)
  20.         Maximum planes to write in a normal ILBM.  If the pixmap does not
  21.         fit into <n> planes, ppmtoilbm writes a HAM file (if -hamif is
  22.         used), a 24bit file (if -24if is used) or a direct color file
  23.         (if -dcif is used) or aborts with an error.
  24.  
  25.     -fixplanes|-fp n (min 1, max 16)
  26.         If a normal ILBM is written, it will have exactly <n> planes.
  27.  
  28.     -hambits|-hamplanes n (default 6, min 3, max 16)
  29.         Select number of planes for HAM picture.  The current Amiga hardware
  30.         supports 6 and 8 planes, so for now you should only use this values.
  31.  
  32.     -normal (default)
  33.         Turns off -hamif/-24if/-dcif, -hamforce/-24force/-dcforce and
  34.         -cmaponly.
  35.  
  36.     -hamif (*)
  37.     -24if (*)
  38.     -dcif (*)
  39.         Write a HAM/24bit/direct color file if the pixmap does not fit into
  40.         <maxplanes> planes.
  41.  
  42.     -hamforce (*)
  43.     -24force (*)
  44.     -dcforce (*)
  45.         Write a HAM/24bit/direct color file.
  46.  
  47.     -dcbits|-dcplanes r g b (default 5, min 1, max 16)
  48.         Select number of bits for red, green & blue in a direct color ILBM.
  49.  
  50.     -ecs (default)
  51.         Shortcut for: -hamplanes 6 -maxplanes 5
  52.  
  53.     -aga
  54.         Shortcut for: -hamplanes 8 -maxplanes 8
  55.  
  56.     -ham6 (default)
  57.         Shortcut for: -hamplanes 6
  58.  
  59.     -ham8
  60.         Shortcut for: -hamplanes 8
  61.  
  62.     -map ppmfile
  63.         Write a normal ILBM using the colors in <ppmfile> as the colormap.
  64.         The colormap file also determines the number of planes, a -maxplanes
  65.         or -fixplanes option is ignored.
  66.  
  67.     -cmaponly
  68.         Write a colormap file: only BMHD and CMAP chunks, no BODY chunk,
  69.         nPlanes = 0.
  70.  
  71.  
  72. Chunks written:
  73.  
  74.                 normal               color- direct
  75.                 ILBM   HAM    24bit  map    color
  76.     -----------+------+------+------+------+------
  77.     BMHD        *      *      *      *      *
  78.     CMAP        *      * (1)  -      *      -
  79.     BODY        *      *      *      -      *
  80.     other       -      CAMG   -      -      DCOL
  81.     nPlanes     1-8    3-8    24     0      3-24    if configured w/o ILBM_BIGRAW
  82.     nPlanes     1-16   3-16   24     0      3-48    if configured with ILBM_BIGRAW
  83.  
  84.     (1): HAM files always have a grayscale colormap
  85.  
  86.  
  87. BUGS:
  88.     Needs a real colormap selection algorithm for HAM pictures, instead
  89.     of using a grayscale colormap.
  90.  
  91.  
  92. #############################################################################
  93.  
  94. ilbmtoppm [-verbose] [ilbmfile]
  95.  
  96.  
  97. Supported ILBM types:
  98.     * normal ILBMs with 1-16 planes
  99.     * EHB
  100.     * HAM with 3-16 planes
  101.     * 24bit
  102.     * colormap (BMHD + CMAP chunk only, nPlanes = 0)
  103.     * unofficial direct color with 1-16 planes for each color component
  104.  
  105.  
  106. Options:
  107.     Options marked with (*) can be prefixed with "no", ie "-noverbose" etc.
  108.     All options can be abbreviated to their shortest unique prefix.
  109.  
  110.     -verbose (*)
  111.         Give some information about the ILBM file
  112.  
  113.  
  114. Known chunks:
  115.     used     : BMHD, CMAP, CAMG (only HAM & EHB flags used), BODY
  116.                unofficial DCOL chunk to identify direct color ILBM
  117.     ignored  : GRAB, DEST, SPRT, CRNG, CCRT, CLUT, DPPV, DRNG, EPSF
  118.     other (1): NAME, AUTH, (c), ANNO, DPI
  119.     unknown chunks are skipped
  120.  
  121.     (1): ignored, but displayed in verbose mode
  122.  
  123.